org.globalplatform.contactless
Interface GPCLRegistryEntry2

All Superinterfaces:

GPCLRegistryEntry, GPRegistryEntry, javacard.framework.Shareable

public interface GPCLRegistryEntry2
extends GPCLRegistryEntry

The GPCLRegistryEntry2 interface extends the GPCLRegistryEntry interface with additional methods to manage GlobalPlatform registry entries.

All OPEN-owned objects implementing the GPRegistryEntry interface shall also implement and may be casted to the GPCLRegistryEntry and the GPCLRegistryEntry2 interfaces.

When an Application is deleted, then the GPCLRegistryEntry2 object corresponding to this Application shall be disabled and all its methods shall throw a javacard.framework.SystemException with reason code SystemException.ILLEGAL_USE. The OPEN shall ensure that this GPCLRegistryEntry2 object can never be re-enabled, even if an Application with the same AID as the Application previously bound to this GPCLRegistryEntry2 object is installed. An application holding a reference to a disabled GPCLRegistryEntry2 object should release it, as it has become useless and will only throw exceptions.

Note: Developers shall pay attention of the CRELApplication, CLApplet and CRSApplication interfaces being notified upon usage of GPCLRegistryEntry2 services. Therefore, it is strongly recommended not to call the services provided by this interface when a Java Card transaction is under progress.

Since:

export file version 1.1

See Also:

GPCLSystem.getGPCLRegistryEntry(AID), GPCLSystem.getNextGPCLRegistryEntry(GPCLRegistryEntry, short)

Field Summary

Fields inherited from interface org.globalplatform.contactless.GPCLRegistryEntry

DISPLAY_REQUIREMENT_NO, DISPLAY_REQUIREMENT_YES, IMPLICIT_SELECTION_TYPE_A, IMPLICIT_SELECTION_TYPE_B, IMPLICIT_SELECTION_TYPE_F, INFO_CONTINUOUS_PROCESS, INFO_COUNTER_UPDATE, INFO_DISCRETIONARY_DATA, INFO_DISPLAY_MESSAGE, INFO_DISPLAY_REQUIREMENT, INFO_FAMILY_IDENTIFIER, INFO_IMPLICIT_SELECTION_PROTOCOLS, INFO_IMPLICIT_SELECTION_RECOGNITION_ALGORITHM, INFO_LOGO, INFO_POLICY_RESTRICTED_APPLICATIONS, INFO_PROTOCOL_DATA_TYPE_A, INFO_PROTOCOL_DATA_TYPE_B, INFO_PROTOCOL_DATA_TYPE_F, INFO_URI, PRIVILEGE_CONTACTLESS_ACTIVATION, PRIVILEGE_CONTACTLESS_SELF_ACTIVATION, PROCESS_CONTINUOUS, PROCESS_INTERLEAVED, STATE_CL_ACTIVATED, STATE_CL_DEACTIVATED, STATE_CL_NON_ACTIVATABLE

Fields inherited from interface org.globalplatform.GPRegistryEntry

PRIVILEGE_AUTHORIZED_MANAGEMENT, PRIVILEGE_CARD_LOCK, PRIVILEGE_CARD_RESET, PRIVILEGE_CARD_TERMINATE, PRIVILEGE_CIPHERED_LOAD_FILE_DATA_BLOCK, PRIVILEGE_CVM_MANAGEMENT, PRIVILEGE_DAP_VERIFICATION, PRIVILEGE_DELEGATED_MANAGEMENT, PRIVILEGE_FINAL_APPLICATION, PRIVILEGE_GLOBAL_DELETE, PRIVILEGE_GLOBAL_LOCK, PRIVILEGE_GLOBAL_REGISTRY, PRIVILEGE_GLOBAL_SERVICE, PRIVILEGE_MANDATED_DAP, PRIVILEGE_RECEIPT_GENERATION, PRIVILEGE_SECURITY_DOMAIN, PRIVILEGE_TOKEN_VERIFICATION, PRIVILEGE_TRUSTED_PATH

Method Summary

short

getPartialSelectionOrder() Gets the Selection Priority of this entry used for application selection by AID matching.

Methods inherited from interface org.globalplatform.contactless.GPCLRegistryEntry

addToCRELApplicationList, addToGroupAuthorizationList, getCLState, getInfo, getNextConflictingApplication, getNextCRELApplication, getNextGroupMember, getNextReferencingApplication, isGroupHead, isGroupMember, joinGroup, removeFromCRELApplicationList, removeFromGroupAuthorizationList, setCLState, setInfo, setPartialSelectionOrder

Methods inherited from interface org.globalplatform.GPRegistryEntry

deregisterService, getAID, getPrivileges, getState, isAssociated, isPrivileged, registerService, setState

Method Detail

getPartialSelectionOrder

short getPartialSelectionOrder()

Gets the Selection Priority of this entry used for application selection by AID matching.

Returns:

selection priority (value 0 corresponds to the highest priority).

Throws:

ISOException - with reason

• ISO7816.SW_CONDITIONS_NOT_SATISFIED if the caller has not GPCLRegistryEntry.PRIVILEGE_CONTACTLESS_ACTIVATION

Since:

export file version 1.1